近日发现了一个好用的笔记工具 Loqseq，然而这个工具缺乏直观的指引，所有的功能大多藏在特殊的写法中。这里做一个简单的整理。由于使用的Markdown，后续所有解释的语法都是Markdown形式的。

快捷键

　　有几个重要的快捷键，默认的触发并不方便，这里列出来。

  • 在当前页面搜索，默认是 Ctrl+u，可以改成Ctrl+f，并没有冲突。
  • 向上移动块，可以改为Alt+Up。
  • 向下移动块，可以改为Alt+Down。
  • 和Alt相关的操作大多是控制文本的，例如Alt+l删除当前块。Alt+a移动到块头，Alt+e移动到块尾。
  • Ctrl+Alt+p，类似VSC自带的快捷命令，目前还没有多少功能，可以调整总体设置。
  • Alt+Right，进入聚焦，效果等价于点击每一个块前的小点，从而进入对于块的编辑。Alt+Left可以退出这一层。
  • Ctrl+Shift+1，快捷键列表中没有，打开git指令。

输入操作

  • / 可以调起菜单，选择下面创建的块类别，包括引用等。
  • [[]]可以创建一个引用到以框内名字为名的文章上，如果这个文章不存在，则会创建一篇新文章。
  • (())可以创建一个引用到以框内名字为名的块上。
  • 可以对选中的文本使用两次Alt+(或者Alt+[，可以直接包围选中文字并达到上述效果。
  • #可以创建一个标签，并在该页面中得到所有使用了该标签的页面，这个功能和在块或者页面性质中标注的tags是等价的。
  • Ctrl+Enter可以创建一个TODO标签，在其后写入内容之后回车，会创建一个新的的任务。所有创建的任务可以在页面TODO中找到。可以使用/A来表示优先级。可以使用命令/Deadline来创造一个DDL。或者为任务创造一个计划的时间：/Scheduled。上述两个命令都可以在创建后选择是否重复。对于任务，可以打开计时选项。
  • Markdown的语法是完全的，即公式、引用等语法都是可用的。
  • [A]([[B]])可以为页面B创造一个名为A的链接，并显示A中的文本。对于块则为[A](((B)))。
  • 高级指令：除了使用/打开命令，也可以使用高级命令：<。这个功能更多补齐了Markdown在Logseq中缺失的部分。例如：
    • Quote
    • Src，展示多行代码
    • Query，后面解释
    • 大型标记
      • Note
      • Tip
      • Important
      • Caution
      • Warning
    • Example （类似于多行注释，但会以文本形式展示）
    • Center（居中显示）
    • Verse （这个看起来没什么用）
    • Comment （注释，只会在编辑当前块的时候出现）
    • ……

页面

  • 对每一个块的点都可以右击打开功能选项。其中可以更改该块的背景色、获得该块的引用、或者在右侧栏打开该块。每一个块都可以生成一张卡片（但卡片看起来没什么用的样子）。
  • 别名（Alias）：一个替用的标题名字，可以在页面属性中增加alias:: another_name1, another_name2。
  • 性质
    • 性质被用来标注一个页面或者一个块
    • 页性质是通过在页面的第一个块写入内容作为标注
    • 块性质是在块之外的另一个块标注完成的
    • 当一个性质的内容和一个已有标题的名字相同时，会生成一个到该页面的链接
    • 语法：property:: value（一定需要这个空格，并通过Shift+Enter制造的同块之内添加。）
    • 用途
      • 选择特殊的块或者页面
      • 为事务提供相同的主题
    • 特殊性质
      • tags
      • template：声明这是一个模板页/块
      • collapsed：声明这个块需不需要折叠
      • alias：创造一个别名
      • title：创造一个覆盖文件名的标题名
      • created-at 及 updated-at
      • parent：指向父节点
      • public：在导出为Pages时的时候是否显示

模板

  • 页面和块都可以做成模板
    • 右击块的生成模板，并命名
    • 或者在Properties中加上template:: name
  • 为了使用模板
    • 输入/template
  • 可使用变量
    • 使用 <%sth%> 语法调用
    • today：引向近日的日记
    • yesterday：昨天的日记
    • tomorrow：明天的日记
    • time：当前的时间
    • Last Friday
    • background-image：设置一个背景
    • …

PDF

　　选择这个软件的重要原因之一。

  • 可以在文件中插入PDF文件，通过/asset加入。
  • 可以高亮以上面方法插入的PDF。
  • 之后可以使用(())的方式引用高亮的部分。
  • 同样，也可以高亮区域，并可以复制引向该区域的ID，并使用(())的方式将其引用。引用之后，如同其他链接一样，点击链接会打开对应的PDF，并跳转到对应的段落。
  • 该PDf阅读器支持不同的颜色背景，并可以调出大纲。

查询（Query）

  • 简单查询：{ {query } }（两个大括号应该相邻，由于Hexo的Parser bug，不得不加了一个空格。）
    • 需要在每一个括号之内的第一个声明这一层运算的类别，例如And或者Or。
    • { {and [[tag1]] [[tag2]]} }：同时带有标签1和标签2的
    • (not [[tag1]] [[tag2]])：不是2者
      • e.g. { {query (and [[red]] [[yes]])} }：搜索同时在标签中含有Yes和Red的页面。
      • e.g. { {query (and (todo later) ((foobar)))} }：搜索在带有todo标签，且为later，以及带有 tag:: foobar 的块。
    • (property A B)：搜索带有property类别为A且其值为B的块。
      • e.g. (property type book)：搜索类别为书的块。
    • (page B)：在页面A内搜索。
      • e.g. (and (page "B") ((foobar)))：在页面B内搜索tag包含foobar的块。
    • (priority a)：搜索priority为A的页面/块。
    • (page-tags A)：显示tags带有A的页面。
    • (all-page-tags)：显示所有的tag。
    • sort-by key order / sort-by key
      • 常用的Key：created-at, updated
      • 常用的Order：desc, asc
      • e.g. (and (todo now later) (sort-by created-at desc))
  • 复杂查询
    • 使用{}，以下是一个模板
      1
      2
      3
      4
      5
      6
      7
      {:title  [:h2 "Your query title"]
       :query  [:find (pull ?b [*])
              :where ...]
       :inputs [...]
       :view             (fn [query-result] [:div ...])
       :result-transform (fn [query-result] ...)
       :collapsed? true}
    • 这个功能过于复杂，暂不展开

其他

  • 图谱：图谱是通过引用自动创建的（这个其实才是这个笔记软件的核心功能，但是都是自动生成的，所以没什么需要单独介绍的）。
  • 导出：在需要导出的根页面点击导出。如果希望导出所有文章，就在该根页面的设置中选择，允许导出所有内容。在导出的附件中可以看到所有的Assets中包含的文章。导出的文件包可以完整地实现在编辑过程中看到的一切内容，但是形式变为只读的。
  • 演讲者模式：在一个文件右键三点，打开演讲者模式，可以逐个展示块。
  • 卡片：用来辅助记忆的一个功能。可以设置简单的问答，但似乎暂时用不到，故不展开。
  • 绘画：使用/draw指令来打开一个嵌入的画板。
  • 支持自定义主题，只需要将custom.css放入logseq得到子文件夹下。这是一系列主题。

　　这样才是对其文档进行了一遍整理，实际使用应该会有一定出入。如有更多问题/发现的新功能，请留在回复处。